Silent Installation

Um Komponenten ohne Benutzerinteraktion und ggf. automatisiert zu installieren, kann der Gesamtinstaller oder die einzelnen Komponenteninstaller verwendet werden. Technisch gesehen sind im Gesamtinstaller diese Einzelinstaller ebenfalls enthalten, siehe auch Installation IQ4docs Server-System.

Sie erhalten die Installer einzeln auf Nachfrage bei Ihrem IQ4docs Ansprechpartner.

Bei der Silent-Installation mit dem Gesamtinstaller werden die gewünschten Features und zusätzlich die Installationsorte sowie weitere Installationsparameter angegeben.

Nach der Angabe des Installerpaketes werden die Parameter mit einem Schrägstrich (slash, /) begonnen und mit danach der Wert mit einem Doppelpunkt oder einem Gleichheitszeichen angehangen. Groß- und Kleinschreibung der Parameter wird beachtet.

Parameter Erklärung Mögliche Werte oder Beispiel
/silent Installation wird silent, d.h. ohne eingeblendete Benutzerdialoge, ausgeführt keine
/language Sprache deutsch 1031
/ISFeatureInstall Namen der Installationsfeatures, kommagetrennt Essentials, MongoDB, RabbitMQ, SystemConfigurationIIS, ConfigService, WebAdmin, WebClient, LicenseService, AccountingService, AddressbookService, AuthenticationService, DeviceService, EpsonComService, Fleet, FleetComService, HpComService, ImageService, NotificationService, PostBoxService, PrintService, ReportService, SharpComService, TerminalComService, UserService, WindowsAuthService, WorkflowService
/ISRootStagePath Installationsverzeichnis, komplette Pfadangabe "c:\Installationsverzeichnis"
/CreateSystemUser Systemanwender erzeugen true oder false
/SystemUserName Name des Systemanwenders, wenn CreateSystemUser nicht true ist. user@factory.local
/SystemUserPassword Passwort des Systemanwenders, wenn CreateSystemUser nicht true ist. password
/SystemUserPasswordCrypted Passwort des Systemanwenders in verschlüsselter Form, wenn CreateSystemUser nicht true ist. Wird das Passwort unverschlüsselt und verschlüsselt angegeben, wird das verschlüsselte verwendet. 6FINUy7gWDyPN41mQn4zAg==
/ClusterInstallation Clusterinstallation durchführen true oder false
/ClusterInstallationHostnameFirstNode Hostname des Servers im Cluster, der zuerst installiert wird (muss bei allen Clusterknoten gleich angegeben werden). server01
/ClusterInstallationMongoDB Clusterinstallation für MongoDB durchführen true oder false
/ClusterInstallationRabbitMQ Clusterinstallation für RabbitMQ durchführen true oder false
/ClusterInstallationSecurityKey Sicherheitsschlüssel für RabbitMQ und MongoDB Clusterverbund, beliebige Zeichenkette, die nur aus Buchstaben und Zahlen bestehen darf. w4u5zoawer9wz78raow83zoawze2ri6uazvbuiwer
/noliccheck Prüfung beim Update auf einen gültigen Software-Pflegevertrag ausschalten (z.B. wenn der Webrequest des Installers zum LicenseService fehlschlägt). In diesem Fall ist manuell zu prüfen, ob ein gültiger Servicevertrag vorliegt, da die installierte Softwareversion sonst nicht lauffähig ist. true oder false

In diesem Beispiel (muss in einer Zeile angegeben werden) wird der Installer (Installer.exe) auf deutsch silent installiert. Es werden alle Features installiert. Das Installationsverzeichnis ist C:\Printsystem 4. Der Systemanwender wird automatisch erstellt.

C:\temp\Installer.exe /silent /language:1031 /ISFeatureInstall="Essentials, MongoDB, RabbitMQ, SystemConfigurationIIS, ConfigService, WebAdmin, WebClient, LicenseService, AccountingService, AddressbookService, AuthenticationService, DeviceService, EpsonComService, Fleet, FleetComService, HpComService, ImageService, NotificationService, PostBoxService, PrintService, ReportService, SharpComService, TerminalComService, UserService, WindowsAuthService, WorkflowService" /ISRootStagePath="C:\Printsystem 4" /CreateSystemUser=true

Zwischen den Features wurde hier zur besseren Darstellung ein Leerzeichen eingefügt - Beim Aufruf des Kommandos darf in der Featureliste bei ISFeatureInstall KEIN Leerzeichen vorkommen.

Die Installation der Features wird in Reihenfolge der Liste ausgeführt.

In diesem Beispiel (muss in einer Zeile angegeben werden) wird der Installer (Installer.exe) auf deutsch silent installiert.

  • Es werden alle Features installiert.
  • Das Installationsverzeichnis ist C:\Printsystem 4.
  • Es wird kein Systemanwender erstellt (/CreateSystemUser=false), stattdessen der bestehende Anwender factory\user mit Passwort geheim verwendet.
  • Es wird eine Clusterinstallation vorgenommen. Der Cluster wird für MongoDB und RabbitMQ erstellt. Der Name des ersten Clusterknotens ist W2019STD01 und der Sicherheitsschlüssel lautet SicherIstSicher123.

C:\temp\Installer.exe /silent /language:1031 /ISFeatureInstall="Essentials, MongoDB, RabbitMQ, SystemConfigurationIIS, ConfigService, WebAdmin, WebClient, LicenseService, AccountingService, AddressbookService, AuthenticationService, DeviceService, EpsonComService, Fleet, FleetComService, HpComService, ImageService, NotificationService, PostBoxService, PrintService, ReportService, SharpComService, TerminalComService, UserService, WindowsAuthService, WorkflowService" /ISRootStagePath="C:\Printsystem 4" /CreateSystemUser=false /SystemUserName=factory\user /SystemUserPassword=geheim /ClusterInstallation=true /ClusterInstallationHostnameFirstNode="W2019STD01" /ClusterInstallationMongoDB=true /ClusterInstallationRabbitMQ=true /ClusterInstallationSecurityKey="SicherIstSicher123"

Zwischen den Features wurde hier zur besseren Darstellung ein Leerzeichen eingefügt - Beim Aufruf des Kommandos darf in der Featureliste bei ISFeatureInstall KEIN Leerzeichen vorkommen.

Die Installation der Features wird in Reihenfolge der Liste ausgeführt.

Um eine Installation zu aktualisieren - egal ob eine Single-Server-Installation oder einen Clusterknoten - geben Sie einfach den Parameter /silent und /language an (die zu aktualisierenden Pakete werden automatisch ermittelt). Starten Sie nach einem Update den Rechner neu.

C:\temp\Installer.exe /silent /language:1031

Ab IQ4docs 4.15 wird die Updateberechtigung im Installer geprüft, da ein gültiger Servicevertrag von der IQ4docs geprüft wird. Schlägt die Lizenzprüfung im Installer fehl, obwohl der Supportvertrag gültig ist (das kann passieren, wenn der Webrequest des Installers zum LicenseService fehlschlägt), kann der Installer mit dem Kommandozeilenparameter /noliccheck aufgerufen werden um die Lizenzprüfung zu überspringen (dies sollte nur getan werden, wenn der Servicevertrag gültig ist, da IQ4docs sonst nicht lauffähig ist).

C:\temp\Installer.exe /noliccheck=true

Die Komponenteninstaller verfügen über eine vereinfachte GUI und werden auch bei Verwendung des Gesamtinstallers sichtbar, wenn über die Systemsteuerung eine einzelne Komponente des Komplett-Paketes deinstalliert wird. Für jeden Komponenteninstaller ist eine Silent Installation möglich.

Es sind für alle IQ4docs Systemkomponenten Komponenteninstaller erhältlich (MongoDB, RabbitMQ, Weboberflächen und alle Microservices), siehe IQ4docs Serverkomponenten.

Mit einem Komponenteninstaller wird mittels parametrisiertem Aufruf eine Antwort-Datei aufgezeichnet (siehe Kommandozeilenparameter). Diese enthält die Eingaben, die der Anwender während des Installerlaufes vornimmt. Bei einer Silent Installation wird dem Komponenteninstaller dann diese Datei übergeben, so dass keine Benutzereingaben mehr erforderlich sind. Bei der Datei handelt es sich um ein einfaches Textformat, das auch nachträglich noch mit einem einfachen Editor bearbeitet werden kann.

Nachfolgend ein Beispiel einer *.iss-Datei für die Installation des IQ4docs HPComServices. Diese kann so wie hier dargestellt verwendet werden, es muss nur unter szDir der gewünschte Installationspfad eingetragen werden.
[InstallShield Silent]
Version=v7.00
File=Response File
[File Transfer]
OverwrittenReadOnly=NoToAll
[{F216936B-3D5E-49F5-B43A-E235BE12A63B}-DlgOrder]
Dlg0={F216936B-3D5E-49F5-B43A-E235BE12A63B}-SdWelcome-0
Count=6
Dlg1={F216936B-3D5E-49F5-B43A-E235BE12A63B}-SdLicense2Rtf-0
Dlg2={F216936B-3D5E-49F5-B43A-E235BE12A63B}-SdAskDestPath2-0
Dlg3={F216936B-3D5E-49F5-B43A-E235BE12A63B}-SdStartCopy2-0
Dlg4={F216936B-3D5E-49F5-B43A-E235BE12A63B}-MessageBox-0
Dlg5={F216936B-3D5E-49F5-B43A-E235BE12A63B}-SdFinish-0
[{F216936B-3D5E-49F5-B43A-E235BE12A63B}-SdWelcome-0]
Result=1
[{F216936B-3D5E-49F5-B43A-E235BE12A63B}-SdLicense2Rtf-0]
Result=1
[{F216936B-3D5E-49F5-B43A-E235BE12A63B}-SdAskDestPath2-0]
szDir=c:\IQ4docs 4
Result=1
[{F216936B-3D5E-49F5-B43A-E235BE12A63B}-SdStartCopy2-0]
Result=1
[{F216936B-3D5E-49F5-B43A-E235BE12A63B}-MessageBox-0]
Result=5
[{F216936B-3D5E-49F5-B43A-E235BE12A63B}-SdFinish-0]
Result=1
bOpt1=0
bOpt2=0

Schalter Beschreibung
/r Der Installer läuft im Aufzeichnungsmodus. Eine Antwort-Datei (*.iss, Installshield Silent) wird aufgezeichnet während der Anwender die Dialoge durchläuft und ausfüllt. Die Installation wird dabei ganz normal ausgeführt.
/s Der Installer läuft im Silentmodus. Eine Antwort-Datei (*.iss) wird ausgewertet, und die darin enthaltenen Werte verwendet, um die Installation auszuführen.
/f1 Mit diesem Schalter wird der Name der Antwort-Datei vorgegeben. Es sollte immer der absolute Pfad angegeben werden, weil ggf. ein weiterer Prozess vom Installer gestartet wird, und dieser auch auf diese Datei zugreifen muss.
/v Über diesen Schalter können weitere Parameter an den Installer übergeben werden, die in unserem Code ausgewertet werden.

im folgenden Beispiel ist die Silent-Installation eines IQ4docs HPcomService beschrieben.

Zunächst wird die setup.iss Datei erzeugt, die für die Silent-Installation benötigt wird.

  • IQ4docs-HPcomService.exe /r /f1"C:\Mein\Verzeichnis\setup.iss"

Das Ergebnis ist ein installierter IQ4docs HPcomService und die Antwort-Datei setup.iss. Diese kann für die Silent-Installation mit einem Texteditor angepasst werden. Dann wird die Datei als Variable bei der Silent Installation angegeben.

  • IQ4docs-HPcomService.exe /s /f1"C:\Mein\Verzeichnis\setup.iss" /v"--Language=DE"

Die Sprache sollte immer als weiterer Parameter angegeben werden.